home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_hylafax.idb / usr / freeware / catman / u_man / cat1 / pdf2fax.Z / pdf2fax
Text File  |  2002-07-08  |  5KB  |  122 lines
  1. PDF2FAX(${MANNUM1_8})                PDF2FAX(${MANNUM1_8})
  2.  
  3.  
  4.  
  5. NNAAMMEE
  6.        pdf2fax    - image    Portable Document Format file for facsim
  7.        ile transmission    by _H_y_l_a_F_A_X
  8.  
  9. SSYYNNOOPPSSIISS
  10.        $${{SSPPOOOOLL}}//bbiinn//ppddff22ffaaxx [ _o_p_t_i_o_n_s ]    [ _f_i_l_e_s...  ]
  11.  
  12. DDEESSCCRRIIPPTTIIOONN
  13.        _p_d_f_2_f_a_x takes Portable Document    Format    (PDF)  input  and
  14.        generates a TIFF    Class F    image file suitable for    facsimile
  15.        transmission.  It is usually invoked by the _H_y_l_a_F_A_X sched
  16.        uler  process,  _f_a_x_q(${MANNUM1_8}).   PDF imaging is typi
  17.        cally done using    the freely  available  _G_h_o_s_t_s_c_r_i_p_t  soft
  18.        ware.
  19.  
  20.        _p_d_f_2_f_a_x    is actually a link (symbolic or    otherwise) to the
  21.        script appropriate for the PDF imaging tool.  The link  is
  22.        setup  when  the     _f_a_x_s_e_t_u_p(${MANNUM1_8})     script    is run to
  23.        configure a _H_y_l_a_F_A_X server machine for use.
  24.  
  25.        Input files containing PDF may be specified on the command
  26.        line.   If  none     are  given,  then _p_d_f_2_f_a_x will    read from
  27.        standard    input.
  28.  
  29.        By default, _p_d_f_2_f_a_x will    generate a  98    line/inch  output
  30.        document     whose    page width is 1728 pixels and page length
  31.        is 297 mm (a standard A4    page at    low  resolution).   Hori
  32.        zontal resolution is always 204 dpi.  Command line options
  33.        may be used to select alternate    vertical  resolution  and
  34.        page dimensions.
  35.  
  36.        If  no  filename     is given, _p_d_f_2_f_a_x writes its output to    a
  37.        file named ppddff..ffaaxx; the --oo option can be    used  to  specify
  38.        an alternate filename.
  39.  
  40.        By  default, output is compressed using the standard Group
  41.        3 1D-encoding scheme, with EOL codes padded to byte bound
  42.        aries.    If  the    --22 option is specified,    output is encoded
  43.        with the    optional Group 3 2D-encoding  scheme  (EOL  codes
  44.        are still padded    to byte    boundaries).
  45.  
  46.        Note  that  bbiinn//ppddff22ffaaxx    is usually just    a link to a shell
  47.        script that invokes the appropriate  PDF     RIP  to  do  the
  48.        work.
  49.  
  50. OOPPTTIIOONNSS
  51.        The following operations    are recognized:
  52.  
  53.        --11     Write    Group  3  1D-encoded  data  to the output
  54.          file.
  55.  
  56.        --22     Write Group 3    2D-encoded  data  to  the  output
  57.          file.
  58.  
  59.        --mm _p_a_g_e_s     Set the maximum number    of pages that are permit
  60.          ted in    the output file.  If more pages    are  pre
  61.          sent  in  the input document then abort process
  62.          ing.
  63.  
  64.        --oo _f_i_l_e     Write output to the specified    _f_i_l_e  instead  of
  65.          the default ppddff..ffaaxx filename.
  66.  
  67.        --ww _w_i_d_t_h     Set  the  output  page     _w_i_d_t_h,     in  pixels.   By
  68.          default, pages    are 1728 pixels    wide.
  69.  
  70.        --ll _l_e_n_g_t_h Set the output    page _l_e_n_g_t_h in    millimeters.   By
  71.          default, pages    are 297    millimeters long.
  72.  
  73.        --rr _v_r_e_s     Set  the  vertical resolution,    in lines/inch, at
  74.          which to image    the PDF.
  75.  
  76. RRUUNNTTIIMMEE    EENNVVIIRROONNMMEENNTT
  77.        Before user-supplied PDF    is passed to the PDF interpreter,
  78.        a  limited  number of operators are defined.  These opera
  79.        tors are    operators commonly found in a LaserWriter printer
  80.        and (sometimes) generated by Macintosh-based applications.
  81.  
  82.        The  default  Display  PDF-based      execution   environment
  83.        includes    support    for the    following fonts:
  84.        AvantGarde-Book         Helvetica-Bold             Palatino-BoldItalic
  85.        AvantGarde-BookOblique     Helvetica-BoldOblique         Palatino-Italic
  86.        AvantGarde-Demi         Helvetica-Narrow         Palatino-Roman
  87.        AvantGarde-DemiOblique     Helvetica-Narrow-Bold         StoneSerif
  88.        Bookman-Demi         Helvetica-Narrow-BoldOblique     Symbol
  89.        Bookman-DemiItalic     Helvetica-Narrow-Oblique     Tekton
  90.        Bookman-Light         Helvetica-Oblique         Times-Bold
  91.        Bookman-LightItalic     Lithos-Bold             Times-BoldItalic
  92.        Courier             NewCenturySchlbk-Bold         Times-Italic
  93.        Courier-Bold         NewCenturySchlbk-BoldItalic     Times-Roman
  94.        Courier-BoldOblique     NewCenturySchlbk-Italic     ZapfChancery-MediumItalic
  95.        Courier-Oblique         NewCenturySchlbk-Roman         ZapfDingbats
  96.        Helvetica         Palatino-Bold
  97.        Note  that  this    is the same set    of fonts supported by the
  98.        DPS extension to    the X server.
  99.  
  100.        The default Ghostscript-based environment is  more  uncer
  101.        tain;  consult  the Ghostscript documentation for informa
  102.        tion on what fonts are available.
  103.  
  104. BBUUGGSS
  105.        Output from the Display PDF version  of    this  command  is
  106.        encoded    according to the Display PDF binary encoding pro
  107.        tocol.
  108.  
  109.        Ghostscript-based versions of this program  fail     to  exit
  110.        with  non-zero status when an invalid PDF document is pro
  111.        cessed; this makes it problematic for  the  _H_y_l_a_F_A_X  queue
  112.        manager    to determine when a problem arises when    preparing
  113.        a job for transmission.
  114.  
  115. SSEEEE AALLSSOO
  116.        _s_e_n_d_f_a_x(1),   _f_a_x_q(${MANNUM1_8}),    _h_y_l_a_f_a_x_-_s_e_r_v_e_r_(_$_{_M_A_N_
  117.        _N_U_M_4___5_}_)
  118.  
  119.  
  120.  
  121.               March    08, 2001    PDF2FAX(${MANNUM1_8})
  122.